package com.youlai.boot.modules.game.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.youlai.boot.modules.game.model.entity.GameUserRecord;
import com.youlai.boot.modules.game.model.query.GameUserRecordQuery;
import com.youlai.boot.modules.game.model.vo.GameUserRecordVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;
import java.util.Map;

/**
 * 游戏用户记录Mapper接口
 *
 * @author 有来技术团队
 */
@Mapper
public interface GameUserRecordMapper extends BaseMapper<GameUserRecord> {

    /**
     * 分页查询用户游戏记录
     *
     * @param page 分页参数
     * @param query 查询条件
     * @return 用户游戏记录列表
     */
    Page<GameUserRecordVO> getUserGameRecords(Page<GameUserRecord> page, @Param("query") GameUserRecordQuery query);

    /**
     * 查询用户游戏类型分布
     *
     * @param userId 用户ID
     * @return 游戏类型分布数据
     */
    List<Map<String, Object>> getGameTypeDistribution(@Param("userId") Long userId);

    /**
     * 查询用户游戏进度列表
     *
     * @param userId 用户ID
     * @param limit 限制数量
     * @return 游戏进度列表
     */
    List<Map<String, Object>> getGameProgressList(@Param("userId") Long userId, @Param("limit") Integer limit);

    /**
     * 更新游戏记录的游戏时长
     *
     * @param id 记录ID
     * @param increment 增加的时长(秒)
     * @return 影响行数
     */
    int incrementPlayTime(@Param("id") Long id, @Param("increment") Integer increment);
} 